package com.aims.server.service;

import com.aims.api.entity.Account;
import com.aims.api.entity.query.AccountQuery;
import com.aims.common.model.PageResult;

import java.io.Serializable;
import java.util.Collection;
import java.util.List;

/**
 * 账户服务接口
 *
 * <p>依赖 DAO：AccountDao</p>
 *
 * @author Generator
 * @since 2025-10-22
 */
public interface AccountService {

    /**
     * 创建账户
     *
     * @param account 账户对象
     * @return 账户ID
     */
    Long create(Account account);

    /**
     * 创建账户（仅非空字段）
     *
     * @param account 账户对象
     * @return 账户ID
     */
    Long createSelective(Account account);

    /**
     * 批量创建账户
     *
     * @param accounts 账户列表
     * @return 影响行数
     */
    int batchCreate(List<Account> accounts);

    /**
     * 根据ID更新账户
     *
     * @param account 账户对象
     * @return 影响行数
     */
    int updateById(Account account);

    /**
     * 根据ID更新账户（仅非空字段）
     *
     * @param account 账户对象
     * @return 影响行数
     */
    int updateSelectiveById(Account account);

    /**
     * 根据ID和版本号更新账户（乐观锁）
     *
     * @param account 账户对象
     * @return 影响行数
     */
    int updateByIdWithVersion(Account account);

    /**
     * 批量更新账户
     *
     * @param accounts 账户列表
     * @return 影响行数
     */
    int batchUpdate(List<Account> accounts);

    /**
     * 根据ID逻辑删除账户
     *
     * @param id 账户ID
     * @return 影响行数
     */
    int deleteById(Serializable id);

    /**
     * 根据ID集合批量逻辑删除账户
     *
     * @param ids 账户ID集合
     * @return 影响行数
     */
    int deleteByIds(Collection<? extends Serializable> ids);

    /**
     * 根据ID查询账户
     *
     * @param id 账户ID
     * @return 账户对象，不存在返回 null
     */
    Account getById(Serializable id);

    /**
     * 根据账户编号查询账户
     *
     * @param accountNo 账户编号
     * @return 账户对象，不存在返回 null
     */
    Account getByAccountNo(String accountNo);

    /**
     * 根据条件查询账户列表
     *
     * @param query 查询条件
     * @return 账户列表
     */
    List<Account> listByCondition(AccountQuery query);

    /**
     * 根据条件统计账户数量
     *
     * @param query 查询条件
     * @return 账户数量
     */
    long countByCondition(AccountQuery query);

    /**
     * 分页查询账户
     *
     * @param query    查询条件
     * @param pageNo   页码（从1开始）
     * @param pageSize 每页大小
     * @return 分页结果
     */
    PageResult<Account> page(AccountQuery query, int pageNo, int pageSize);
}